home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 050a / fold30.zip / FOLDADD.DOC < prev    next >
Text File  |  1993-01-31  |  8KB  |  263 lines
  1.  
  2.                                FOLD-and-PRINT
  3.                                  version 3.0
  4.  
  5.                           Appendix to User's Manual
  6.  
  7.                           (C) Konrad Budych 1989-93
  8.  
  9.  
  10.         This appendix does not contain vital information that you need to run
  11. FOLD-and-PRINT.  It contains information that I always hate reading in other
  12. people's manuals.  Please have a look at FOLD.DOC first, and after you have
  13. done that, you may come back here...
  14.  
  15.  
  16.  
  17.  
  18. DISCLAIMER
  19. ==========
  20.  
  21.     FOLD-and-PRINT is supplied as is.  The author disclaims all warranties,
  22. expressed or implied, including, without limitation, the warranties of
  23. merchantability and of fitness for any purpose.  The author assumes no
  24. liability for any damages, direct or consequential, which may result from the
  25. use of, or inability to use FOLD-and-PRINT.
  26.  
  27.  
  28.  
  29.  
  30. WHERE TO BUY FOLD-and-PRINT?
  31. ============================
  32.  
  33.  
  34.         Nowhere.  FOLD-and-PRINT is free.  I wrote it for myself, but now I
  35. think more people can enjoy and make use of it.  You may give FOLD-and-PRINT
  36. away to your friends, but you are not permitted to sell or modify it.  If you
  37. distribute FOLD-and-PRINT, please distribute the original, unmodified archive
  38. file.
  39.  
  40.         If you think this program is great and worth contributing, please send
  41. something to the author (diskettes, money, postcards, your programs, etc.).
  42. You can contact the author via e-mail or via snail mail using the following
  43. addresses:
  44.  
  45. Snail mail address:
  46.  
  47.         Konrad Budych
  48.         os.Boh.Wrzesnia 24/67
  49.         31-621 Krakow, Poland
  50.  
  51. Internet address:
  52.  
  53.         kbudych@ii.uj.edu.pl
  54.  
  55.         Very strange things often happen to ii.uj.edu.pl host so do not give
  56. up easily when you get no answer!
  57.  
  58.  
  59.  
  60.  
  61. ACKNOWLEDGEMENTS
  62. ================
  63.  
  64.     I would like to thank Jerzy Jamski, Jerzy Polczynski, and Krzysztof
  65. Dziechciarz for testing FOLD-and-PRINT, and especially to Edgar W. Swank for
  66. some suggestions and 'debugging' the manual.
  67.  
  68.  
  69.  
  70.  
  71. REVISION HISTORY
  72. ================
  73.  
  74.         The history of FOLD-and-PRINT is long and interesting.
  75.  
  76.  
  77.  
  78.  
  79. VERSIONS 1.0 thru 1.3
  80. ---------------------
  81.  
  82.     The first version of this program was running under CP/M-80.  It was
  83. written in Turbo Pascal 3.0 (!).  There were two parts: one which reformatted
  84. input file into another file; the second part printed that file.  All
  85. necessary parameters had to be entered each time the program was run.  Printer
  86. control codes were located inside the program and could not be changed without
  87. the recompilation of the source code as I used only one printer.
  88.  
  89.     The first part, which created the reformatted file, could also act on
  90. the WordStar 3.0 document files.
  91.  
  92.  
  93.  
  94.  
  95. VERSIONS 2.0A thru 2.0J
  96. -----------------------
  97.  
  98.     The version 2.0 was written with the use of Turbo Vision library in
  99. Turbo Pascal 6.0.  This program was a 'concatenation' of the previous two.
  100. All parameters could be set in the program and the configuration could be
  101. saved.  Several sets of control codes were still inside the program and only
  102. ESC/P compatible printers could be used.
  103.  
  104.     There was a possibility of printing selected pages and truncating
  105. lines.  An input file still was first formatted into temporary file which was
  106. then printed. It sometimes took a while to reformat a long text.
  107.  
  108.     A lot of keys has to be pressed to start printing.
  109.  
  110.  
  111.  
  112.  
  113. VERSIONS 2.91 thru 2.98
  114. -----------------------
  115.  
  116.     As I found that I always use only two print modes, I thought of the
  117. separate configuration files for each of them.  A command line utility was the
  118. next idea.  A word wrap looks great when there are broken lines and the text
  119. is not a source code.  Printing separately odd and even pages was necessary as
  120. I started using a printer with the sheet feeder.  Printing each line few times
  121. was a great idea when I was forced to use printers with the very weak ribbons.
  122.  
  123.     FOLD-and-PRINT only reads now an input file: no temporary file is
  124. created.  This saves a lot of time: the page is reformatted and immediately
  125. printed; the program prepares the next page while the previous one is being
  126. printed.  The text is read once if no analysis is performed, however if you
  127. want to know how many pages the text will have, it has to be read twice and
  128. the text analysis has to be performed.
  129.  
  130.     All necessary printer information is now in the printer definition
  131. file.  This allows (probably) all printers to be used.
  132.  
  133.     Version 2.91 thru 2.98 were all pre-release versions of 3.0.  They
  134. were not widely distributed, but were still improved.  The suggestion form a
  135. number of people shaped FOLD-and-PRINT into its final form.
  136.  
  137.  
  138.  
  139.  
  140. VERSION 3.0
  141. -----------
  142.  
  143.     This version was the first to be widely distributed.
  144.  
  145.  
  146.  
  147.  
  148. FUTURE VERSIONS
  149. ---------------
  150.  
  151.         I think it is not history yet, but this is the best place to inform
  152. you about the future (of FOLD-and-PRINT).
  153.  
  154.         I cannot promise that there ever will be any future version of
  155. FOLD-and-PRINT, but I am afraid that there will.  I have improved this program for
  156. more than 3 years (for a few days each year...), to add something I need, remove
  157. something I dislike, etc.  I already have some new ideas that may
  158. influence the future of FOLD-and-PRINT but nothing is certain...
  159.  
  160.  
  161.  
  162.  
  163. EXIT CODES AND ERRORS
  164. =====================
  165.  
  166.     If you are interested what exit codes FOLD-and-PRINT returns, here is
  167. the brief list:
  168.  
  169.     0 - everything was okay, the text has been printed
  170.     1 - the help screen has been displayed
  171.     2 - there were problems with command line parameters or FOLD variable
  172.     4 - there were problems with the printer configuration file
  173.     5 - there were problems with the input file
  174.     6 - there were problems with the output file or the printer
  175.     9 - [ESC] has been pressed
  176.     
  177.     And here you have the list of all possible error messages and the
  178. short descriptions of them:
  179.     
  180.  
  181. Invalid digit after 'b'.
  182. Invalid number after 'f'.
  183. Invalid number after 'l'.
  184. Invalid number after 's'.
  185.  
  186.     The number specified after the switch is not a valid decimal number.
  187. Only one digit is allowed after 'b'.
  188.  
  189. Invalid data in printer definition file 'FILE.EXT'.
  190. Invalid hex code in printer definition file 'FILE.EXT'.
  191. Invalid number in printer definition file 'FILE.EXT'.
  192. Invalid structure of printer definition file 'FILE.EXT'.
  193.  
  194.     The printer configuration file is invalid: contains invalid number of
  195.     entries or/and invalid entries or/and the heading or/and ending is
  196.     missing.  Please refer to the user's manual for the detailed
  197.     description of this file.
  198.  
  199. Invalid switch: '-Z'.
  200.  
  201.     The switch ('Z' in the example) is unknown and has no meaning.
  202.  
  203. Missing file name in command line.
  204.  
  205.     You have not given any file name in the command line.  If the name of
  206.     the file you want to print begins with '-', use '-' before.
  207.  
  208. No pages to print.
  209.  
  210.     You have specified an invalid range of pages to print.  For example:
  211.     '-f10 -t5' or both 'e' and 'o' switch are on.
  212.  
  213. No printable text in input file 'FILE.EXT'.
  214.  
  215.     The file to be printed is empty.  This is detected only in the text
  216.     analyzis mode.
  217.  
  218. Non-printable character(s) in text.
  219.  
  220.     The text to print cannot contain control characters.
  221.  
  222. Not enough memory to allocate page buffer.
  223.  
  224.     There is not enough memory for FOLD-and-PRINT to work in the specified
  225.     mode. Remove some TSRs and retry.
  226.  
  227. Too long printer control sequence.
  228.  
  229.     The printer control sequences must not be longer than 128 characters.
  230.  
  231. Too many columns specified for this paper width.
  232.  
  233.     The page is too narrow or/and the number of columns is too big.
  234.  
  235. Too many files specified in command line.
  236.  
  237.     You can specify only one file to print in the command line.
  238.  
  239. Unable to open configuration file 'FILE.EXT'.
  240.  
  241.     The printer configuration file should be located in the current
  242.     directory or in the FOLD.EXE home directory.
  243.  
  244. Unable to open input file 'FILE.EXT'.
  245.  
  246.     The file to be printed is missing or/and has another name.
  247.  
  248. Unable to open output file 'FILE.EXT'.
  249.  
  250.     The output file cannot be opened / created.  This can happen only if
  251.     you tell FOLD-and-PRINT to print to the file.
  252.  
  253. Unable to print.
  254.  
  255.     FOLD-and-PRINT encountered problems with a printer while printing.
  256.  
  257.  
  258.  
  259.  
  260.                        End of Appendix to User's Manual
  261.                        ********************************
  262.  
  263.